home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 030 (1987-08-15)(Ossowski, Stefan)(DE)(PD).zip / Taifun 030 (1987-08-15)(Ossowski, Stefan)(DE)(PD).adf / WBrun / WBRun.doc < prev    next >
Text File  |  1978-08-10  |  4KB  |  89 lines
  1. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  2. /* |_o_o|\\ Copyright (c) 1986 The Software Distillery.  All Rights Reserved */
  3. /* |. o.| || This program may not be distributed without the permission of   */
  4. /* | .  | || the authors.                                                    */
  5. /* | o  | ||    Dave Baker    Ed Burnette        Stan Chow         BBS:      */
  6. /* |  . |//     Jay Denebeim  Gordon Keener      Jack Rouse   (919)-471-6436 */
  7. /* ======       John Toebes   Mary Ellen Toebes  Doug Walker                 */
  8. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  9.  
  10. WBRun by John Toebes - Copyright (c) 1986 The Software Distillery.
  11.                                           All Rights Reserved
  12.  235 Trillingham Ln, Cary, NC 27511
  13.  
  14. Other Freely Redistributable Products produced by the Software Distillery are:
  15.    BLINK     - the Turbo-charged Alink replacement
  16.    POPCLI II - Screen saver and Pop up CLI hotkey
  17.    HACK      - The Amiga port of the famous UNIX game
  18.    MAKE      - A software development tool one shouldn't be without
  19.    KERMIT    - The World renown file transfer protocol brought to the Amiga
  20.    ICONEXEC, SETALTERNATE, SETWINDOW - Icon manipulation tools
  21.    TSIZE     - A short utility for determining directory sizes.
  22.    MEMWATCH  - A utility to catch and correct random low memory trashing
  23. All of these are available on our BBS.
  24.  
  25. Permission is hereby granted to distribute this program provided both this
  26. documentation accompanies the executable and that no charge is made for its
  27. distribution.  Contributions to the Distillery at the above address are
  28. encouraged and go to support further development.  If you wish
  29. to include this program in a comercial product, contact us first.
  30.  
  31. WBRun is a program designed to allow any program to be invoked from CLI yet
  32. behave as if it were invoked from Workbench.  Note that workbench need not
  33. be loaded!  This is a boon for people who are short on memory and do not
  34. wish the extra overhead of workbench.
  35.  
  36. This permits running programs created with AmigaBasic and TrueBasic (or
  37. any other application that creates a workbench project icon) from CLI
  38. as either a turnkey application or even in a startup-sequence.
  39.  
  40. To invoke a program with WBRun you need to execute the command:
  41.   WBRun <icon1> <icon2> ...
  42.  
  43. Where <icon1> is the primary program to be run.  The name must correspond
  44. to a workbench Icon.  <icon2> and subsequent parameters are taken as 
  45. workbench arguments to be passed to the primary program.
  46.  
  47. For example:
  48.    To run Initialize:
  49.       WBRun SYS:System/Initialize
  50.  
  51.    To run a program (call it Printit) that takes arguments (normally shift
  52.    clicked on) you would type
  53.       WBRin Printit Arg1 Arg2
  54.  
  55. To run an AmigaBasic Program:
  56.   WBRun myprogram
  57.  
  58. Note that the arguments must be qualified if they are not in the current
  59. directory.
  60.  
  61. Supressing the Copyright message:
  62.   If you are building a turnkey application that you do not wish to have
  63. display the WBRun copyright message, you may supress it with the CLI
  64. redirection features:
  65.    WBRun >NIL: MyApplication
  66.   To autostart an application from the startup-sequence, you would want to use:
  67.      RUN >nil: <nil: WBRun MyApplication
  68.  
  69. If you do this, you must give credit to the Software Distillery in your
  70. application.
  71.  
  72. Known Bugs:
  73.   Fails to compile or execute under Manx.
  74.  
  75. How it works:
  76.   WBRun simulates a phoney workbench by building an argument list of the
  77. locks and names corresponding to the command line arguments.  It then opens
  78. up the disk object for the first argument to determine the tool type.  For
  79. a TOOL it simply invokes that program, for a Project it determines the
  80. default tool to be invoked.  Once the program to be invoked is determined,
  81. it does a LoadSeg on it, CreateProc and sends the startup message to the
  82. newly created task.  Finally it waits for the response message from the
  83. task before terminating.  All resources allocated are freed upon completion
  84. or any error.
  85.  
  86. The code is written completely in Lattice C under 3.10 taking advantage
  87. of Blink.  There is no guarentee that it will compile under anything but
  88. the latest version.
  89.